home *** CD-ROM | disk | FTP | other *** search
/ Aminet 7 / Aminet 7 - August 1995.iso / Aminet / gfx / show / Slider22.lha / Slider / Doc / Slider2_2.Doc < prev    next >
Encoding:
Text File  |  1995-05-30  |  10.5 KB  |  381 lines
  1. ------------------------------------------------------------------------------
  2.           T H E  A M O S  P R O  P I C T U R E  S L I D E R  V 2.2
  3. ------------------------------------------------------------------------------
  4.  
  5.                 M.VERNAGLIONE * HEGELSTR.72 * 63303 DREIEICH
  6.  
  7.                             Fido: 2:2461/318.3
  8.  
  9.                                   19.11.94
  10.  
  11.  
  12. \
  13. If you don´t have got the Fullversion by me, or you have tested the Demo-
  14. version, so please let you register. You can do this by sending a Euro-
  15. Cheque about 15 DM. For orders please include 5 DM for Disc and Charge fee
  16. ( Germany ) or 7 DM for other countries.
  17.  
  18. When you attempt to put any of your Slideshows in Public Domain, or you
  19. give it to a friend.... please use the sliplayer program to show the
  20. Slideshow. There will be more space for pictures and modules.
  21.  
  22.  
  23.                               -/- MANUAL -/-
  24.  
  25.  
  26. Files : Slider2.2        - mainprogram for generating and testing your
  27.                            slideshows
  28.         Sliplayer        - this do not have a syntaxchecker and is shorter.
  29.                            (for presenting your slideshows)
  30.         Checker          - a scriptchecker
  31.                          - call as the slider
  32.         Slider2.2.Dok    - german manual
  33.         Slider2.2.Doc    - this english manual
  34.  
  35.        - Slider2.2 needs always Mathtrans.library and Medplayer.library just
  36.          for playing MED Modules.
  37.  
  38. ATTENTION: Slider works on Machines with OS1.3 up to 3.0. Under OS3.1 it 
  39.            is unable to display interlaced screens ( Bug in Amospro ).
  40.  
  41.  
  42.  
  43. Starting: Slider [ Scriptfile Path ] ( example: ' Slider df0:s/ ' )
  44. If you start Slider without path it will get ' Sys:s/ ' as Default.
  45.  
  46. You can also start your Slideshows from Workbench:
  47. You need a Project-Icon with defaultool ' IconX ' and rename that as
  48. example: Slideshow.info.
  49. Then you generate a ASCII-textfile with following lines:
  50.  
  51. Disc:path/slider disc:scriptpath/  example : Slide:c/slider Slide:s/
  52.  
  53. and save this with the name Slideshow.
  54.  
  55. Now you can doubleclick the Slideshow Icon to start the Slideshow!
  56.  
  57. ------------------------------------------------------------------------------
  58.  
  59.  
  60. -/- The script file -/-
  61.  
  62. * Can contain up to 256 lines and 100 characters.
  63.   All above this limits can cause program errors or too long waittimes.
  64.  
  65.  
  66. Displaying a picture:
  67.  
  68.  Discname:path/picturename Inscroll Speed1 Outscroll Speed2 Wait
  69.  .
  70.  .
  71.  .
  72.  .
  73.  repeat or end
  74.  
  75.  MUSIC or NOMUSIC
  76. ------------------------------------------------------------------------------
  77.  
  78. - Inscroll:
  79.  
  80.   Fades or scrolls in a picture
  81.  
  82.   up - scroll up
  83.   dn - scroll down
  84.   ru - decrease height of the old picture, the back (second) picture becomes
  85.        visible.
  86.   rd - same as 'ru' but down
  87.   sh - shows a picture immediately
  88.   fd - colorfading
  89.   fl - Flickereffect for a definite time
  90.        you can see the new picture and the old picture, black screen or
  91.        a rainboweffect shining through.
  92.  
  93.   su - same as 'up' but the old picture will be replaced by the new one from
  94.        bottom to above
  95.  
  96.   sd - same as 'su' but down
  97.   an - loads a ANIM-IFF5 animation and plays
  98.        you can use scrollcommands for first and last picture by a trick:
  99.  
  100.        example:
  101.  
  102.        - Anims:anim.01 up 1 ne 0 0  - loads first picture and scrollup
  103.        - Anims:anim.01 an 0 fd 3 5  - loads whole animation and after
  104.                                       playing 5 times colorfades out
  105.  
  106. ------------------------------------------------------------------------------
  107.  
  108. - Outscroll:
  109.  
  110.   Out scroll or fading the Picture.
  111.  
  112.   ne - no Effect, the old picture will be at the same place for next effect
  113.   up - scrolls up
  114.   dn - scrolls down
  115.   fd - fades out
  116.   Fl - Flickereffect same as 'fl' from inscroll
  117.   cl - cleans the screen immediately
  118.   a1 - a horizontal linepattern cleans the screen in two passes, first the
  119.        even lines then the odd lines
  120.   a2 - same effect as 'a1' but vertically
  121.   a3 - cleans horizontally the odd end even lines in one pass, the even
  122.        from left to right and the odd from right to left
  123.   a4 - same as 'a3' but vertically
  124.  
  125.   b1 - effect similar that when you turn off a TV (not really realistic)
  126.  
  127.   c1 - a checkerpattern cleans the screen in two passes
  128.  
  129.   e1 - a line cleans with circular movements the screen
  130.  
  131.   * Do not use fd a2 a4 b1 c1 and e1 with HAM Pictures (fringes)
  132.  
  133. ------------------------------------------------------------------------------
  134.  
  135. - Speed1
  136.  
  137.   - sh                 - no sense
  138.   - up/dn/ru/rd/su/sd  - Effectspeed (1-Slow)
  139.   - fd                 - Effectspeed (1-Fast)
  140.   - fl                 - Effecttime  (1-Very short)
  141.   - an                 - nope
  142.  
  143.  
  144. - Speed2
  145.  
  146.   - cl                 - nope
  147.   - up/dn              - Effectspeed (1-Slow)
  148.   - fd                 - Effectspeed (1-Fast)
  149.   - fl                 - Effecttime  (1-Very short)
  150.   - a1/a2/a3/a4        - nope
  151.   - b1                 - Fadeoutspeed of remaining spot
  152.   - c1                 - dimension of boxes, high number = little boxes
  153.   - e1                 - step
  154.  
  155. ------------------------------------------------------------------------------
  156.  
  157. - Wait
  158.  
  159.   Waits for n seconds before loading next picture or apply scrollout effect.
  160.   You can break the waitloop by pressing right mousebutton.
  161.  
  162.   If you have put 'an' in commandline, so 'wait' is the amount of times were
  163.   the animation will be played.
  164.  
  165. ------------------------------------------------------------------------------
  166.  
  167. - repeat/end   repeat loop slideshow
  168.                end    break slide after last picture
  169.  
  170.  
  171.  
  172. -------------------------------------------------------------------------------
  173.                          *** COLORBACKGROUNDS ***
  174. ------------------------------------------------------------------------------
  175.  
  176. You can put colorcommands in the script:
  177.  
  178. Back <Color> <pos> <cchng/scan>
  179.  
  180.  
  181. - Color:
  182.  
  183.   WHITE   : CopperBar Color
  184.   RED     :
  185.   GREEN   :
  186.   BLUE    :
  187.   RGB     :
  188.   CYAN    :
  189.   MAGENTA :
  190.   YELLOW  :
  191.   DEL     : kills the Copperbackground * no parameters there
  192.  
  193.  
  194. - Pos:
  195.  
  196.   vertical Positionadjust of rainbows
  197.  
  198. - Cchng/Scan:
  199.  
  200.   color change per scanline.
  201.  
  202.   A value of 1 changes the color every line, 2 changes the color every 2 
  203.   scanlines and so on.
  204.  
  205.  
  206. Example :
  207.  
  208.  Back BLUE 0 1
  209.  Pictures:Infopic up 1 up 1 10
  210.  Back DEL
  211.  pictures:pic1 sh 0 up 5
  212.  .
  213.  .
  214.  
  215. Colorregister 0 is transparent for Copperbackgrounds.
  216. When you want to display pictures over a copperbackground, you must
  217. kill the colorregister 0 from the contens of the picture.
  218.  
  219. The Slider is not able to display ECS or AA pictures.
  220.  
  221. ------------------------------------------------------------------------------
  222.                    *** Playing Musix in Slideshows ***
  223. ------------------------------------------------------------------------------
  224.  
  225.  
  226. - MUSIC/NOMUSIC
  227.  
  228.   - The last command in a slidescript and must be ever been in script
  229.     followed by a ´Return´
  230.  
  231.   MUSIC   : Slider searchs the script > muz.script < in the same path
  232.             where the Slidescript is and plays the modules listed
  233.             in the script
  234.  
  235.             If you want to hear one single music trough the slideshow, you put
  236.             just only one module in the list
  237.  
  238.             For more musix after a slidepass put more modules in the list
  239.  
  240.  
  241.   NOMUSIC : No musix
  242.  
  243.  
  244.  
  245. The Music-Script
  246.  
  247. Discname:Path/Musicname
  248. .
  249. .
  250. .
  251.  
  252.  
  253. Slider2.2 can play :
  254.  
  255.  - Med Modules (MMD0/MMD1)
  256.  - Sound/noise/ProTracker-Modules
  257.  - Amos Bank (.abk) Modules
  258.  
  259.  
  260. ------------------------------------------------------------------------------
  261.  * Script-Syntax-Errors were only listed by Slider2.2 and not by Sliplayer *
  262.           Sliplayer is to use in finished and tested Slideshows
  263. ------------------------------------------------------------------------------
  264.  You can quit slideshows by pressing both mousebuttons, but you must press
  265.  in the waitdelay. When a scrolleffect is running you cannot abort.
  266. ------------------------------------------------------------------------------
  267. ******************************************************************************
  268.  
  269. When you have a combination of 16-Color-Hireslaces pics and Coppereffect, so
  270. you have probably irregularitys in smooth scroll, because the CPU not even
  271. becomes the necessary CPU-cycles for the scroll loops.
  272. When you own an Amiga with 68000 CPU or/and you habe only chipmem, i suggest 
  273. to only use Lowrespics and background. Laced Pics are better displayed without
  274. copperbackground.
  275.  
  276. Only the scrollcommands UP,DN,SU,SD,RU,RD have this restriction.
  277.  
  278. ******************************************************************************
  279.  
  280. The programm tells you what´s wrong when you have put nonexisting pictures
  281. or modules in the scripts.
  282.  
  283. ******************************************************************************
  284.  
  285. New features probably included in the next version 2.3:
  286.  
  287. 1) User-interface (?)
  288.  
  289. 2) play samples (??)
  290.  
  291. 3) Support of powerpacked files (??????)
  292.  
  293. ? = probability to include this function
  294.  
  295. ******************************************************************************
  296.  
  297. History:
  298.  
  299. * V0.9 *
  300.  
  301. I was searching a good slideshowprogram in PD, but theese was not good enough
  302. for my pourposes, so i decided to program one. As base for the Slider i've got
  303. the code of an slidedemo, that i programmed to present my videodigis.
  304. This demo had the pictures embedded into the code and the effects implemented
  305. was UP, DN and FD.
  306.  
  307.  
  308. * V1.0 *
  309.  
  310. Scriptcontrol over the slideshow
  311.  
  312. * V1.8 - V2.0 *
  313.  
  314. All effects and Copperbackgrounds.
  315.  
  316. * V2.1 *
  317.  
  318. Changes since v2.0
  319.  
  320. - Audiofilterbug fixed
  321.  
  322. - RD: Last line was invisible * fixed
  323.  
  324. - C1: After the effect the screen was not closed * fixed
  325.  
  326. - better errorhandling
  327.  
  328. - wait abort by pressing RMB
  329.  
  330. ------------------------------------------------------------------------------
  331. * V2.2 *
  332.  
  333. Changes since V2.1
  334.  
  335. - Syntaxchecker
  336.  
  337. - even better errorhandling
  338.  
  339. - scriptprocessing optimized
  340.  
  341. - effect d1 and moving rainbows killed, because not useful and bad routines
  342.  
  343. - requester will be open on Workbench
  344.  
  345. - on errors the files were not closed * fixed
  346.  
  347. - rainbow variable intensity killed
  348.  
  349. - changes in the syntax of copperbackground commands
  350.  
  351. * textscrolling was implemented for a time, but the textmovement was too
  352.   silly. It´s better to program in assembler by other people. If you have
  353.   any interrests please contact me...
  354.  
  355.   (you have to be able to programm in AmosPro and Assembler)
  356.  
  357. ------------------------------------------------------------------------------
  358.                       -/- TO ALL USERS OF THIS PROGRAM -/-
  359.  
  360. Please send me an error-report if you get errors or if you see errors in
  361. the scrolleffects. Please include the bad slideshow-disc and backcharging fee.
  362.  
  363. Asta la vista...
  364.  
  365.  
  366. Thanx to all registred users of my program :
  367.  
  368. Richard Diezmann
  369.  
  370. Holger Helmprecht
  371.  
  372. R.CH.Blume
  373.  
  374. Hans-Joachim Johns
  375.  
  376. Klaus Moeckel
  377.  
  378. Robin Wernard
  379.  
  380. Thorsten Nilson
  381.